docs: Add a note on GtkPasswordEntry's secure storage

diff --git a/gtk/gtkpasswordentry.c b/gtk/gtkpasswordentry.c
index dfef7681354c410fc8231ffd30bfbeaafab43af5..a9fbd6f30bfb8c787be94ec22d678a83c894c9f8 100644 (file)
--- a/gtk/gtkpasswordentry.c
+++ b/gtk/gtkpasswordentry.c
@@ -42,7 +42,10 @@
  *
  * #GtkPasswordEntry is entry that has been tailored for entering secrets.
  * It does not show its contents in clear text, does not allow to copy it
- * to the clipboard, and it shows a warning when Caps Lock is engaged.
+ * to the clipboard, and it shows a warning when Caps Lock is engaged. If
+ * the underlying platform allows it, GtkPasswordEntry will also place the
+ * text in a non-pageable memory area, to avoid it being written out to
+ * disk by the operating system.
  *
  * Optionally, it can offer a way to reveal the contents in clear text.
  *